home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / packet / bpq408a / ipgate.doc < prev    next >
Text File  |  1995-02-04  |  7KB  |  176 lines
  1.             G8BPQ IP Router.
  2.  
  3. *** Changes have been made to the way subnet masks are specified, and *** 
  4. *** to the format of the 'RIP' updates. Please read sections on ROUTE ***
  5. *** and RIP commands before upgrading from Version 1.x to 2.x         ***
  6.  
  7.  
  8.  
  9. The IP router runs with BPQCODE versions 4.06c and above. It is
  10. normally run in a Desqview window (currently needs about 64k).
  11. Once loaded it looks rather like PAC4, and can display traffic passing
  12. through. The system is initially configured by commands in a file
  13. IPGATE.CFG. See below for format. The system will learn the IP addresses
  14. of stations which attempt to use the router, and will pass both
  15. preconfigured and learned addresses to neighbouring BPQ routers at regular
  16. intervals. The Protocol used is derived from RIP, but is not compatible
  17. with other RIP implementations. The program updates IPGATE.CFG as it
  18. learns new routes, or deletes old ones, so that the current state can
  19. be restored when it is reloaded.
  20.  
  21.  
  22. There is a very primitive SYSOP interface with the following commands:
  23.  
  24. A    Display ARP Table
  25. D    Diagnositic dump
  26. N    Display RIP Destinations (Neighbours)
  27. R    Display Route Table
  28. S    Display Stats
  29. T    Force a RIP Transmission
  30. PING aaa.bbb.ccc.ddd    Send an ICMP Echo packet to specified address
  31.             (This must be specified as a 'dotted decimal'
  32.             address, not a host name)
  33.  
  34. ROUTE .....        ; Equivalent to the commands in IPGATE.CFG to add
  35. ARP .....        ; Route ARP or RIP table entries. See below for
  36. RIP ....        ; details. Note that these commands must be entered
  37.             ; in UPPER CASE
  38.  
  39. CTRL/Y shuts down IPGATE
  40.  
  41.  
  42. The Stats display is pretty obvious. The ROUTES display is as follows:
  43.  
  44. Target/Subnet    Router         Port Type Metric Flags  Time  Count 
  45.  
  46. 44.131.4.30/32  44.131.4.18      1    V    2     02     00    0 
  47.  
  48. The first field is the target address, followed by the number of bits
  49. to be used in comparing addresses. The number is 32 for a route to a
  50. specific station, but may be less to allow groups of stations to be reached
  51. via one entry, a technique often known as 'Subnet Routing'. For example,
  52. an entry of 44.131.20.0/24 would route traffic for any station on Zone 20.
  53.  
  54. The next is the router to use, or 0.0.0.0 for a direct path. Port is the
  55. Radio port to use, and Type the session type (V=Virtual Circuit,N=NETROM,
  56. D=Datagram). Metric is the number of hops to the station. Flags indicates
  57. whether the route is learned (1),or entered by SYSOP (2). Time is the number
  58. of hours left before a learned route is deleted, and Count is the number of
  59. frames sent over this route.
  60.  
  61. The ARP display is as follows:
  62.  
  63. Callsign    IP Address        Timeout  Port  Type
  64. G8BPQ-5     44.131.4.18          65535    00    N
  65.  
  66. The timeout is in seconds, and 65535 indicates a locked entry.
  67.  
  68.  
  69. Please note that although the router supports both Virtual Circuit and
  70. Datagram mode, I strongly recommend that you only use Virtual Circuit
  71. mode on radio links.
  72.  
  73. The following is a commented extract from my IPROUTE.CFG
  74.  
  75. #
  76. #    Any lines starting with a # are ignored.
  77. #
  78. #    You must tell the system its IP Address. Note that if you are
  79. #    running a NOS (or similar) system as well, it must have a
  80. #    different address
  81. #
  82. IPADDRESS=44.131.4.20        
  83. #
  84. #    You can disable the route learning mechanism by replacing the
  85. #    following line with LEARN N
  86. #
  87. LEARN Y
  88. #
  89. #    You can put in ROUTE commands to tell the system where to send
  90. #    frames for each station. You specify the IP address, the next
  91. #    Router in the path (if you cant reach the station directly), the
  92. #    Radio Port to use (as defined in BPQCFG), and the frame type.
  93. #
  94. #    ROUTE 44.131.4.18 * 1 V
  95. #
  96. #    This means station 44.131.4.18 can be reached on port 1, using
  97. #    Virtual Circuit mode.
  98. #
  99. #    ROUTE 44.141.5.1 44.131.27.1 0 N
  100. #
  101. #    This means station 44.131.5.1 is reachable via router 44.131.27.1,
  102. #    which is via a NETROM link. Port is 0, as the NETROM system will
  103. #    choose the best port.
  104. #
  105. #    It is possible to specify the number of bits of the address to be
  106. #    compared when selecting a route. This is done by adding a /nn after
  107. #    the address, where nn is the number of bits to check. For example,
  108. #    the following will route all traffic for zone 18 via 44.131.18.24
  109. #
  110. #    ROUTE 44.131.18.0/24 44.131.18.24 0 N
  111. #
  112. #     You can define a 'Default Route' - somewhere for the Router to
  113. #    send frames if it doesnt know where the station is.
  114. #
  115. ROUTE DEFAULT * 1 V            # Try port 1 for all unknown dests
  116. #
  117. ROUTE 44.131.4.15 * 1 V            # Directly reachable stations. You
  118. ROUTE 44.131.4.32 * 1 V            # may wish to define all your local
  119. ROUTE 44.131.4.33 * 1 V            # users.
  120.  
  121. ROUTE 44.131.4.18 * 2 V            # My WNOS system on a 'LOOPBACK' port
  122.  
  123. ROUTE 44.131.4.23 * 0 N         # G0INA ROUTER. Must be defined, as
  124.                     # system can't learn the address of
  125.                     # NETROM stations.
  126. #
  127. ROUTE 44.131.4.92 44.131.4.57 1 V    # g1xow - need this one, as he is not
  128.                     # running a version which uses RIP
  129. #
  130. ROUTE 44.131.18.0 44.131.18.24 0 N        # G4MCF and zone 18 - running NOS, so
  131.                     # cant be learned 
  132. #
  133. #
  134. #    The system will discover the callsign to be used to talk to
  135. #    directly reachable stations using the ARP protocol. However it
  136. #    cant discover the callsign to be used for NETROM links, so you
  137. #    must include ARP entries for all your NETROM neighbours. You can
  138. #    put in ARP commands for other stations, but that shouldn't be
  139. #    necessary.
  140. #
  141. ARP 44.131.4.23 G0INA-1 0 N
  142. ARP 44.131.18.24 G4MCF-5 0 N
  143. #
  144. #    The Router will exchange routing information with other Routers,
  145. #    if they are defined using a RIP command. Note that the RIP table
  146. #    defines both the stations to which you will send RIP messages,
  147. #    and the stations from which you will ACCEPT RIP messages.
  148. #    This helps to prevent non-reciprocal routes being created.
  149. #
  150. RIP 44.131.4.23                # G0INA
  151. #
  152. #    Version 2.0 and above of IPGATE    use a different format of Routing
  153. #    information update messages. No action is needed if all stations
  154. #    in an area are using the same version, but if a station running
  155. #    the new version is sending routing info to an older one, a /O 
  156. #    should be added to the RIP statement, so that the update messages
  157. #    will be sent in the correct format:
  158. #
  159. RIP 44.131.4.91/O            # G4IRX has not yet updated to V2
  160.  
  161.  
  162. #    Note that G4MCF is running NOS, not my Router, so I cant send
  163. #    him RIP info.
  164.  
  165. From version 2.1 onwards, it is possible to add 3 extra fields to the
  166. ROUTE command. These are Obsolescence count, Metric (hops to destination),
  167. and entry type (1 Learned, 2 = Locked by SYSOP). These fields are primarily
  168. to allow the router to recover its current state after a reload, but you
  169. can add them if required.
  170.  
  171. The foreground version of BPQCODE (SWITCH.EXE) now includes IPGATE
  172. functionality. Key F10 to toggle between the IPGATE and terminal screens.
  173.  
  174. John Wiseman G8BPQ
  175. 3/12/93
  176.